Skip to content

docs: add OpenCode v1.2.x vs v1.4.0 plugin interface research#73

Merged
tryweb merged 1 commit intomainfrom
docs/opencode-version-research
Apr 8, 2026
Merged

docs: add OpenCode v1.2.x vs v1.4.0 plugin interface research#73
tryweb merged 1 commit intomainfrom
docs/opencode-version-research

Conversation

@tryweb
Copy link
Copy Markdown
Owner

@tryweb tryweb commented Apr 8, 2026

Summary

  • Add docs/opencode-plugin-interface-research.md - comprehensive version comparison
  • Update docs/OPENCODE_COMPATIBILITY.md with v1.4.0 breaking changes
  • Add Phase 7 to docs/roadmap.md with risk assessment and phased upgrade strategy
  • Add BL-056 to BL-060 to docs/backlog.md (Epic 12 - version compatibility)

Risk Assessment

Risk Level Item Description
🔴 High AI SDK v5→v6 migration (v1.3.4) Affects session.idle hook that triggers auto-capture
🟡 Medium Tool.define() bug fix (v1.3.14) May change execute behavior of 17 tools
🟡 Medium Plugin install mechanism (v1.3.11) Need to verify prepublishOnly still works
🟢 Low v1.4.0 new features Unrelated to this plugin

Upgrade Strategy

1.2.25 → 1.3.14 → (1-2 weeks observation) → 1.4.x (stable)

First step: upgrade to 1.3.14 and run npm run verify:full to validate.

- Add opencode-plugin-interface-research.md with version comparison
- Update OPENCODE_COMPATIBILITY.md with v1.4.0 breaking changes
- Add Phase 7 to roadmap.md with risk assessment and phased upgrade strategy
- Add BL-056 to BL-060 to backlog.md (Epic 12 - version compatibility)

Risk assessment:
- 🔴 High: AI SDK v5→v6 migration (v1.3.4) affects session.idle hook
- 🟡 Medium: Tool.define() bug fix (v1.3.14) affects 17 tools
- 🟡 Medium: Plugin install mechanism (v1.3.11)
- 🟢 Low: v1.4.0 new features unrelated

Upgrade path: 1.2.25 → 1.3.14 → (1-2 weeks observation) → 1.4.x
@tryweb tryweb merged commit 6194bd2 into main Apr 8, 2026
21 of 23 checks passed
@tryweb tryweb deleted the docs/opencode-version-research branch April 8, 2026 09:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant